- Courses
- ItemPath API
- Section 4: Essential Calls
- Creating Orders & Order Lines
- Adding a New Order Line (POST)
Adding a New Order Line (POST)
To create an order line, the ID of the order being added to is required in the body of the request. Each order line also requires a material and quantity. Other order lines body params are optional.
There's an example below, but to try it yourself, you'll need to pass the actual Order ID of the order you created earlier. Feel free to try modifying the fields and values!
Note: Each order line needs a unique line number. If you don't enter a number, it will be automatically assigned in sequence.
Example body:
{
"orderId": "[your order ID]",
"materialId": "C6607DB2-CE96-4888-82A5-71E36EBF2785",
"quantity": 1,
"lot": "Lot42",
"number": 2,
"Info1": "This material has a lot number."
}
Example response:
{
"order_line": {
"modifiedDate": "2022-03-22T20:43:54.773000",
"progressType": 1,
"storageUnits": [],
"id": "DF74472B-829D-46DC-BD99-BA8AD4C36627",
"orderId": "AB5655FA-7674-4414-A4E7-1B9E07EF55C7",
"quantityRequested": 0.0,
"serialNumber": null,
"number": 3,
"pickLocation": null,
"lot": "Lot42",
"pickBinName": null,
"quantityConfirmed": 0.0,
"qualification": null,
"costCenterName": null,
"putDate": null,
"putLocation": null,
"quantityDeviated": 1.0,
"hostIdentification": null,
"putBinName": null,
"Info1": "This material has a lot number.",
"releaseDate": null,
"materialName": "SampleMaterial",
"productionDate": null,
"quantity": 1.0,
"Info2": null,
"status": "queued",
"expiryDate": null,
"incompleteAllocations": 0,
"hasStock": 0,
"putHeight": null,
"materialId": "C6607DB2-CE96-4888-82A5-71E36EBF2785",
"Info5": null,
"Info4": null,
"directionType": 1,
"owner": "sys",
"Info3": null
}
}
Note: If you want to update an order line that has not yet been processed (for example, changing the quantity), you will need need to delete the original order line and send an updated one.